<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>birnd</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
    <link rel="prev" href="biquada.html" title="biquada" />
    <link rel="next" href="bqrez.html" title="bqrez" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">birnd</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="biquada.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="bqrez.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="birnd"></a>
      <div class="titlepage"></div>
      <a id="IndexBirnd" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">birnd</span>
        </h2>
        <p>birnd — 
      Returns a random number in a bi-polar range.
          </p>
      </div>
      <div class="refsect1">
        <a id="idp92248384"></a>
        <h2>Description</h2>
        <p>
      Returns a random number in a bi-polar range.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp92249728"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>birnd</strong></span>(x) (init- or control-rate only)</pre>
        <p>
      Where the argument within the parentheses may be an expression. These value converters sample a global random sequence, but do not reference <span class="emphasis"><em>seed</em></span>. The result can be a term in a further expression.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp92312144"></a>
        <h2>Performance</h2>
        <p>
      Returns a random number in the bipolar range -<span class="emphasis"><em>x</em></span> to <span class="emphasis"><em>x</em></span>. <span class="emphasis"><em>rnd</em></span> and <span class="emphasis"><em>birnd</em></span> obtain values from a global pseudo-random number generator, then scale them into the requested range. The single global generator will thus distribute its sequence to these units throughout the performance, in whatever order the requests arrive.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp92315504"></a>
        <h2>Examples</h2>
        <p>
      Here is an example of the birnd opcode. It uses the file <a class="ulink" href="examples/birnd.csd" target="_top"><em class="citetitle">birnd.csd</em></a>.

      </p>
        <div class="example">
          <a id="idp92317280"></a>
          <p class="title">
            <strong>Example 92. Example of the birnd opcode.</strong>
          </p>
          <div class="example-contents">
            <p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
            <pre class="programlisting">
<span class="csdtag">&lt;CsoundSynthesizer&gt;</span>
<span class="csdtag">&lt;CsOptions&gt;</span>
<span class="comment">; Select audio/midi flags here according to platform</span>
<span class="comment">; Audio out   Audio in</span>
-odac           -iadc    <span class="comment">;;;RT audio I/O</span>
<span class="csdtag">&lt;/CsOptions&gt;</span>
<span class="csdtag">&lt;CsInstruments&gt;</span>

<span class="ohdr">sr</span> <span class="op">=</span> 44100
<span class="ohdr">kr</span> <span class="op">=</span> 4410
<span class="ohdr">ksmps</span> <span class="op">=</span> 10
<span class="ohdr">nchnls</span> <span class="op">=</span> 2

<span class="oblock">instr</span> 1		<span class="comment">; Generate a random number from -1 to 1.</span>
  
kbin <span class="op">=</span>	<span class="opc">birnd</span>(1)
	<span class="opc">printk</span> .2, kbin

<span class="oblock">endin</span>

<span class="csdtag">&lt;/CsInstruments&gt;</span>
<span class="csdtag">&lt;CsScore&gt;</span>

<span class="stamnt">i</span> 1 0 1
<span class="stamnt">i</span> 1 + .
<span class="stamnt">i</span> 1 + .
<span class="stamnt">i</span> 1 + .
<span class="stamnt">i</span> 1 + .
<span class="stamnt">i</span> 1 + .
<span class="stamnt">i</span> 1 + .

<span class="stamnt">e</span>

<span class="csdtag">&lt;/CsScore&gt;</span>
<span class="csdtag">&lt;/CsoundSynthesizer&gt;</span>
</pre>
          </div>
        </div>
        <p><br class="example-break" />

      Its output should include lines like:
      </p>
        <pre class="screen">
instr 1:  i1 = 0.94700
instr 1:  i1 = -0.72119
instr 1:  i1 = 0.53898
instr 1:  i1 = 0.05001
instr 1:  i1 = 0.24533
instr 1:  i1 = 0.93902
instr 1:  i1 = 0.43364
</pre>
        <p>
    </p>
      </div>
      <div class="refsect1">
        <a id="idp92322544"></a>
        <h2>See Also</h2>
        <p>
      <a class="link" href="rnd.html" title="rnd"><em class="citetitle">rnd</em></a>
    </p>
      </div>
      <div class="refsect1">
        <a id="idp92324624"></a>
        <h2>Credits</h2>
        <p>
      </p>
        <table border="0" summary="Simple list" class="simplelist">
          <tr>
            <td>Author: Barry L. Vercoe</td>
          </tr>
          <tr>
            <td>MIT</td>
          </tr>
          <tr>
            <td>Cambridge, Massachussetts</td>
          </tr>
          <tr>
            <td>1997</td>
          </tr>
        </table>
        <p>
    </p>
        <p>Extended in 3.47 to x-rate by John ffitch.</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="biquada.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="OpcodesTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="bqrez.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">biquada </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> bqrez</td>
        </tr>
      </table>
    </div>
  </body>
</html>
